Inside Macintosh: Mac OS 8 Toolbox Reference /

Chapter 2 - Control Manager Reference / Control Manager Functions

Embedding Controls /

DumpControlHierarchy

NEW WITH THE APPEARANCE MANAGER

Writes a textual representation of the control hierarchy for a specified window into a file.

pascal OSErr DumpControlHierarchy (
                     WindowPtr inWindow,
                     const FSSpec* inDumpFile);

inWindow

On input, a pointer to the window whose control hierarchy you wish to debug.

inDumpFile

On input, a pointer to a file specification in which you wish to place a text description of the window's control hierarchy.

function result

A result code; see "Result Codes".

DISCUSSION

The DumpControlHierarchy function places a text listing of the current control hierarchy for the window specified into the specified file, overwriting any existing file. If the specified window does not contain a control hierarchy, DumpControlHierarchy notes this in the text file. This function is useful for debugging embedding-related problems.

SEE ALSO

"Embedding Controls".

"Appearance Manager Gestalt Selector Constants".